You are here: Introduction > Update Intravue

Update Intravue

WBC Network Health Monitor uses the IntraVUE‎ API and the ivDashboard web application to collect data from IntraVUE‎.

The first update of the ivDashboard.war file must be done manually. After that WBC Network Health Monitor will automatically update this file when needed.

 

ClosedHow to Deploy ivDashboard on a local Windows' IntraVUE‎

There are 2 methods of getting the ivDashboard web application installed in Tomcat.

1) The easiest way in Windows is to simply copy the file, like c:\wbcNetworkHealthMonitor\dist\ivDashboard.war to the IntraVUE‎ webapps folder, located by default at c:\intravue\autoip\tomcat8\webapps.

Closed2) The second way is to use the Tomcat Manager, click to expand

The ivDashboard.war file is deployed through the Apache Tomcat Manager's web page. On a local machine the url is http://127.0.0.1:8765/manager/html. The login user and password is the same as you use for IntraVUE‎ For remote Intravue's substitute the ip address of that Intravue.

Open a browser and go to the manager page.

 

At the bottom of the page is the deploy section. Click on 'Choose File' and navigate to the 'dist' folder of WBC Network Health Monitor. Select the ivDashboard.war file. Note, if you are updating the ivDashboard.war file you must first use the Undeploy button where ivDashboard is listed above.

 

ClosedHow to Deploy ivDashboard to a remote Windows IntraVUE‎

On older versions of IntraVUE‎ you can follow the steps for a local Windows machine, except substitute 127.0.0.1 for the remote IP.

Newer versions of IntraVUE‎ have applied security to prevent the Apache Manager from being accessed remotely. Contact WBC-INS tech support for help changing this.

For newer IntraVUE‎ versions, you choices are:

  • You can use Remote Desktop or a similar application to copy ..\wbcNetworkHealthMonitor\dist\ivDashboard.war to the remote Intravue and follow the steps for a local machine above.
  • You can use Remote Desktop or a similar application to copy ..\wbcNetworkHealthMonitor\dist\ivDashboard.war to the remote Intravue and then move the file to ...\intravue\autoip\tomcat8\webapps. Tomcat will then self deploy ivDashboard. (You can overwrite any previous version)
ClosedHow to Initially Deploy ivDashboard to an IntraVUE‎ Edge (Appliance)

All IntraVUE‎ Edges prevent access to the Apache Manager application. The following upload process is only required one time, during the installation. After that the required ivDashboard.war file will be automatically updated as required.

Required Tools

Process Overview

  1. Start Putty or SSH and log into the IntraVUE Edge appliance.
  2. Execute a script that allows root login
  3. Start WinScp, log into the IntraVUE Edge appliance.
  4. Navigate to the web servers webapp folder on the appliance and the \\wbcNetworkHealthMonitor\\dist folder on Windows
  5. Copy the ivDashboard.war file from Windows to the Edge
  6. Change permissions on war file
  7. Close WinScp
  8. Go back to Putty and execute a script that denies root login. Exit.

Detailed Steps

Start SSH or Putty, enter the IP Address of the Edge and Open

Login using user intravue, password intravue
Become the superuser, enter "su -" and enter the root password
enter "cd /root"
enter "sh allowrootlogin.sh"
prompt will change for $ to #

Start WinScp, enter the IP Address of the Edge, root for user and the root password. Login.

  1. Navigate to /opt/intravue/autoip/tomcat8/webapps on the right
  2. Navigate to \wbcNetworkHealthMonitor\dist on the left
  3. If ivDashboard was previously installed you will see the file and a directory already there, delete the .war file. If you refresh the ivDashboard folder will also have been removed.
  4. Right click on ivDashboard.war and Upload
  5. Right click on ivDashboard.war on the right, select Properties, change the Owner from "root" to "tomcat8"

    NOTE: DO NOT FORGET TO CHANGE Properties. This enables automatic updates of the ivDashboard.war file when updates are available, making this a one time only process

  6. After a moment you should see a new folder named ivDashboard appear, if not do a refresh.

Finishing

Close WinScp Go back to Putty
Enter "sh denyrootlogin.sh"
Enter "logout" to exit superuser mode
Enter "logout" to close Putty

Done.

ClosedHow to change ivDashboard.war properties after automatic update in IntraVUE‎ Edge

 

NOTE: The admin should not have to do this, the automatic updating should take care of this. These steps are included in case of an issue.

Process Overview

  1. Start Putty or SSH and log into the IntraVUE Edge appliance.
  2. Execute a script that allows root login
  3. Start WinScp, log into the IntraVUE Edge appliance.
  4. Navigate to the web servers webapp folder on the appliance and the \\wbcNetworkHealthMonitor\\dist folder on Windows
  5. Change user properties on war file from root to tomcat8
  6. Close WinScp
  7. Go back to Putty and execute a script that denies root login. Exit.

Detailed Steps

Start SSH or Putty, enter the IP Address of the Edge and Open

Login using user intravue, password intravue
Become the superuser, enter "su -" and enter the root password
enter "cd /root"
enter "sh allowrootlogin.sh"
prompt will change for $ to #

Start WinScp, enter the IP Address of the Edge, root for user and the root password. Login.

  1. Navigate to /opt/intravue/autoip/tomcat8/webapps on the right
  2. Right click on ivDashboard.war on the right, select Properties, change the Owner from "root" to "tomcat8"
  3. After a moment you should see a date of the folder named ivDashboard be the same as the date of the ivDashboard.war file.

Finishing

Close WinScp Go back to Putty
Enter "sh denyrootlogin.sh"
Enter "logout" to exit superuser mode
Enter "logout" to close Putty

Done.